Skip to content

fix: update contributing links in README for MkDocs compatibility#259

Merged
lsetiawan merged 2 commits intomainfrom
fix/contributing-links
Apr 14, 2026
Merged

fix: update contributing links in README for MkDocs compatibility#259
lsetiawan merged 2 commits intomainfrom
fix/contributing-links

Conversation

@Vraj1234
Copy link
Copy Markdown
Collaborator

@Vraj1234 Vraj1234 commented Apr 7, 2026

Summary

  • docs/README.md is a symlink to the root README.md. MkDocs resolves relative links from docs/ as the base, so the previous docs/CONTRIBUTING.md links were resolving to docs/docs/CONTRIBUTING.md (404).
  • Updated all contributing links to use paths relative to docs/ so they resolve correctly in the MkDocs site while keeping the symlink as the single source of truth.

Test plan

  • Run pixi run -e docs docs-serve and verify all Contributing links on the home page navigate correctly
  • Confirm no new warnings about CONTRIBUTING links in the build output

@read-the-docs-community
Copy link
Copy Markdown

read-the-docs-community bot commented Apr 7, 2026

Documentation build overview

📚 ca-biositing | 🛠️ Build #32246665 | 📁 Comparing 573a6fa against latest (cb3d782)

  🔍 Preview build  

Show files changed (32 files in total): 📝 31 modified | ➕ 1 added | ➖ 0 deleted
File Status
404.html 📝 modified
index.html 📝 modified
CHANGELOG/index.html 📝 modified
CODE_OF_CONDUCT/index.html 📝 modified
CONTRIBUTING/index.html 📝 modified
SECURITY/index.html ➕ added
api/index.html 📝 modified
architecture/index.html 📝 modified
ca_biositing_local_setup/index.html 📝 modified
datamodels/index.html 📝 modified
deployment/index.html 📝 modified
notebook_setup/index.html 📝 modified
pipeline/index.html 📝 modified
resources/index.html 📝 modified
webservice/index.html 📝 modified
api/datamodels/index.html 📝 modified
api/pipeline/index.html 📝 modified
api/webservice/index.html 📝 modified
datamodels/ALEMBIC_VIEW_WORKFLOW/index.html 📝 modified
datamodels/CONTRIBUTING/index.html 📝 modified
datamodels/SCHEMA_DRIFT/index.html 📝 modified
datamodels/SQL_FIRST_WORKFLOW/index.html 📝 modified
pipeline/ALEMBIC_WORKFLOW/index.html 📝 modified
pipeline/CONTRIBUTING/index.html 📝 modified
pipeline/DOCKER_WORKFLOW/index.html 📝 modified
pipeline/ETL_WORKFLOW/index.html 📝 modified
pipeline/GCP_SETUP/index.html 📝 modified
pipeline/PREFECT_WORKFLOW/index.html 📝 modified
webservice/CONTRIBUTING/index.html 📝 modified
pipeline/USDA/ANALYTICS_HANDOFF/index.html 📝 modified
pipeline/USDA/USDA_ETL_GUIDE/index.html 📝 modified
pipeline/USDA/USDA_ETL_HANDOFF/index.html 📝 modified

@mglbleta
Copy link
Copy Markdown
Collaborator

Hi @vrajrajpura @lsetiawan ! Just want to check. This PR doesn't replace docs PR #225 or PR #204 correct? I'm catching up on these docs PR reviews and plan to merge them in #204, #225 and #259 order, being careful when reconciling with altered main.

@lsetiawan
Copy link
Copy Markdown
Collaborator

@Vraj1234 please respond to mei. Additionally, seems like the nav isn't quite working to the specific files, can you please investigate this? Thanks!

@Vraj1234
Copy link
Copy Markdown
Collaborator Author

Hi @mglbleta , you are raight all 3 PRs serve different purposes:

I think merging them in the order you mentioned shouldnt be a problem (there are 2 merge conflicts but they are trivial)

@Vraj1234
Copy link
Copy Markdown
Collaborator Author

@mglbleta No action is needed on your end, will clean up this issue & get it merged. Thanks

@Vraj1234 Vraj1234 force-pushed the fix/contributing-links branch from 7eafad9 to 3883065 Compare April 14, 2026 00:24
@Vraj1234
Copy link
Copy Markdown
Collaborator Author

@lsetiawan Ready to Merge

@lsetiawan lsetiawan merged commit 035a366 into main Apr 14, 2026
12 checks passed
@lsetiawan lsetiawan deleted the fix/contributing-links branch April 14, 2026 17:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants